package com.atguigu.tingshu.search.service;

import com.atguigu.tingshu.query.search.AlbumIndexQuery;
import com.atguigu.tingshu.vo.search.AlbumInfoIndexSearchVo;
import com.atguigu.tingshu.vo.search.AlbumInfoIndexVo;
import com.atguigu.tingshu.vo.search.AlbumSearchResponseVo;

import java.util.List;

public interface SearchService {

    /**
     * 上架专辑
     * @author Petrichor
     * @date 2023/12/26 18:48
     * @param albumId 专辑id
     * @return NULL
     **/
    void upperAlbum(Long albumId);
    /**
     * 下架专辑
     * @author Petrichor
     * @date 2023/12/27 19:00
     * @param albumId 专辑id
     * @return NULL
     **/
    void lowerAlbum(Long albumId);
    /**
     * 检索功能实现 当点击搜索按钮
     * @author Petrichor
     * @date 2023/12/27 18:43
     * @param albumIndexQuery 专辑信息搜索
     * @return albumSearchResponseVo 检索出来的商品信息
     **/
    AlbumSearchResponseVo search(AlbumIndexQuery albumIndexQuery);
    /**
     * @description: 根据一级分类id查询专辑数据
     * @author Petrichor
     * @date 2023/12/27 22:45
     * @param category1Id  一级分类id
     * @return List<AlbumInfoIndexSearchVo> 专辑数据集合
     **/
    List<AlbumInfoIndexSearchVo> channel(Long category1Id);
    /**
     * 关键字自动补全
     * @author Petrichor
     * @date 2023/12/28 21:04
     * @param keyword 关键字
     * @return
     **/
    List<String> completeSuggest(String keyword);
    /**
     * 更新排行榜数据
     * @author Petrichor
     * @date 2024/1/2 16:46
     **/
    void updateLatelyAlbumRanking();
    /**
     * 获取排行榜列表
     * @author Petrichor
     * @date 2024/1/2 19:16
     * @param category1Id 一级分类id
     * @param dimension 热度:hotScore、播放量:playStatNum、订阅量:subscribeStatNum、购买量:buyStatNum、评论数:albumCommentStatNum
     * @return List<AlbumInfoIndexVo> 返回专辑列表
     **/
    List<AlbumInfoIndexVo> findRankingList(Long category1Id, String dimension);
    /**
     * 用于[service.service-album]/com/atguigu/tingshu/album/canal/CanalClientListener.java
     *  的远程调用,更新统计数据
     * @author Petrichor
     * @date 2024/1/5 19:26
     * @param albumId 专辑id
     * @param statType 统计类型：0401-播放量 0402-订阅量 0403-购买量 0403-评论数
     * @param statNum 统计数目
     * @return NULL
     **/
    void updateAlbumStat(Long albumId, String statType, Integer statNum);
}
